home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / Pakiet bezpieczenstwa / mini Pentoo LiveCD 2006.1 / mpentoo-2006.1.iso / livecd.squashfs / etc / conf.d / wireless.example < prev    next >
Encoding:
Text File  |  2006-04-25  |  11.2 KB  |  282 lines
  1. # /etc/conf.d/wireless:
  2. # Global wireless config file for net.* rc-scripts
  3.  
  4. ##############################################################################
  5. # IMPORTANT
  6. # linux-wlan-ng is not supported as they have their own configuration program
  7. # ensure that /etc/conf.d/net has the entry "!iwconfig" in it's modules line
  8. # Try and use an alternative driver if you need to use this - hostap-driver
  9. # supports non-usb linux-wlan-ng driven devices
  10. ##############################################################################
  11.  
  12. ##############################################################################
  13. # HINTS
  14. ##############################################################################
  15. # Remember to change eth0 to your wireless interface which may be
  16. # eth0, eth1, wlan0, ath0 - you get the idea. If you're not sure
  17. # you can type "iwconfig" at the command prompt and it will tell you which
  18. # interfaces are wireless.
  19. # Say that your wireless interface is ath0 - the line
  20. #      #essid_eth0="any"
  21. # becomes
  22. #      #essid_ath0="any"
  23. #
  24. # Remember to change ESSID to your ESSID.
  25. # Say that your ESSID is My NET - the line
  26. #      #key_ESSID="s:passkey"
  27. # becomes
  28. #      #key_My_NET="s:passkey"
  29. # Notice that the space has changed to an underscore - do the same with all
  30. # characters not in a-z A-Z (english alphabet) 0-9. This only applies to
  31. # variables and not values.
  32. #
  33. # Any ESSID's in values like essid_eth0="My NET" may need to be escaped
  34. # This means placing the character \ before the character
  35. # \" need to be escaped for example
  36. # So if your ESSID is
  37. #      My "\ NET
  38. # it becomes
  39. #      My \"\\ NET
  40. # for example
  41. #      #essid_eth0="My\"\\NET"
  42. #
  43. # So using the above we can use
  44. #      #dns_domain_My____NET="My\"\\NET"
  45. # which is an invalid dns domain, but shows the how to use the variable
  46. # structure
  47. #
  48. # As a final note, most users will just need to set the following options
  49. # key_ESSID1="s:yourkeyhere enc open" # s: means a text key
  50. # key_ESSID2="aaaa-bbbb-cccc-dd"      # no s: means a hex key
  51. # preferred_aps=( "ESSID1" "ESSID2" )
  52. #
  53. # Clear? Good. Now configure your wireless network below
  54. #########################################################
  55.  
  56. ##############################################################################
  57. # SETTINGS
  58. ##############################################################################
  59. # Hard code an ESSID to an interface - leave this unset if you wish the driver
  60. # to scan for available Access Points
  61. # Set to "any" to connect to any ESSID - the driver picks an Access Point
  62. # This needs to be done when the driver doesn't support scanning
  63. # This may work for drivers that don't support scanning but you need automatic
  64. # AP association
  65. # I would only set this as a last resort really - use the preferred_aps
  66. # setting at the bottom of this file
  67.  
  68. # However, using ad-hoc (without scanning for APs) and master mode
  69. # do require the ESSID to be set - do this here
  70. #essid_eth0="any"
  71.  
  72. # Set the mode of the interface (managed, ad-hoc, master or auto)
  73. # The default is auto
  74. # If it's ad-hoc or master you also may need to specify the channel below
  75. #mode_eth0="auto"
  76.  
  77. # If managed mode fails, drop to ad-hoc mode with the below ESSID?
  78. #adhoc_essid_eth0="WLAN"
  79.  
  80. #Channel can be set (1-14), but defaults to 3 if not set.
  81. #
  82. # The below is taken verbatim from the BSD wavelan documentation found at
  83. # http://www.netbsd.org/Documentation/network/wavelan.html
  84. # There are 14 channels possible; We are told that channels 1-11 are legal for
  85. # North America, channels 1-13 for most of Europe, channels 10-13 for France,
  86. # and only channel 14 for Japan. If in doubt, please refer to the documentation
  87. # that came with your card or access point. Make sure that the channel you
  88. # select is the same channel your access point (or the other card in an ad-hoc
  89. # network) is on. The default for cards sold in North America and most of Europe
  90. # is 3; the default for cards sold in France is 11, and the default for cards
  91. # sold in Japan is 14.
  92. #channel_eth0="3"
  93.  
  94. # Setup any other config commands. This is basically the iwconfig argument
  95. # without the iwconfig $iface
  96. #iwconfig_eth0=""
  97.  
  98. # Set private driver ioctls. This is basically the iwpriv argument without
  99. # the iwpriv $iface
  100. #iwpriv_eth0=""
  101.  
  102. # Seconds to wait before scanning
  103. # Some drivers need to wait until they have finished "loading"
  104. # before they can scan - otherwise they error and claim that they cannot scan
  105. # or resource is unavailable. The default is to wait zero seconds
  106. #sleep_scan_eth0="1"
  107.  
  108. # Seconds to wait until associated. The default is to wait 10 seconds
  109. #sleep_associate_eth0="5"
  110.  
  111. # By default a successful association in Managed mode sets the MAC
  112. # address of the AP connected to. However, some drivers (namely
  113. # the ipw2100) don't set an invalid MAC address when association
  114. # fails - so we need to check on link quality which some drivers
  115. # don't report properly either.
  116. # So if you have connection problems try flipping this setting
  117. # Valid options are MAC, quality and all - defaults to MAC
  118. #associate_test_eth0="MAC"
  119.  
  120. # Some driver/card combinations need to scan in Ad-Hoc mode
  121. # After scanning, the mode is reset to the one defined above
  122. #scan_mode_eth0="Ad-Hoc"
  123.  
  124. # Below you can define private ioctls to run before and after scanning
  125. # Format is the same as the iwpriv_eth0 above
  126. # This is needed for the HostAP drivers
  127. #iwpriv_scan_pre_eth0="host_roaming 2"
  128. #iwpriv_scan_post_eth0="host_roaming 0"
  129.  
  130. # Define a WEP key per ESSID or MAC address (of the AP, not your card)
  131. # The encryption type (open or restricted) must match the
  132. # encryption type on the Access Point
  133. # You can't use "any" for an ESSID here
  134. #key_ESSID="1234-1234-1234-1234-1234-1234-56"
  135. # or you can use strings. Passphrase IS NOT supported
  136. # To use a string, prefix it with s:
  137. # Note - this example also sets the encryption method to open
  138. # which is regarded as more secure than restricted
  139. #key_ESSID="s:foobar enc open"
  140. #key_ESSID="s:foobar enc restricted"
  141.  
  142. # If you have whitespace in your key, here's how to set it and use other
  143. # commands like using open encryption.
  144. #key_ESSID="s:'foo bar' enc open"
  145.  
  146. # WEP key for the AP with MAC address 001122334455
  147. #mac_key_001122334455="s:foobar"
  148.  
  149. # Here are some more examples of keys as some users find others work
  150. # and some don't where they should all do the same thing
  151. #key_ESSID="open s:foobar"
  152. #key_ESSID="open 1234-5678-9012"
  153. #key_ESSID="s:foobar enc open"
  154. #key_ESSID="1234-5678-9012 enc open"
  155.  
  156. # You may want to set muliple keys - here's an example
  157. # It sets 4 keys on the card and instructs to use key 2 by default
  158. #key_ESSID="[1] s:passkey1 key [2] s:passkey2 key [3] s:passkey3 key [4] s:passkey4 key [2]"
  159.  
  160. # You can also override the interface settings found in /etc/conf.d/net
  161. # per ESSID - which is very handy if you use different networks a lot
  162. #config_ESSID=( "dhcp" )
  163. #dhcpcd_ESSID="-t 5"
  164. #routes_ESSID=()
  165. #fallback_ESSID=()
  166.  
  167. # Setting name/domain server causes /etc/resolv.conf to be overwritten
  168. # Note that if DHCP is used, and you want this to take precedence then
  169. # please put -R in your dhcpcd options
  170. #dns_servers_ESSID=( "192.168.0.1" "192.168.0.2" )
  171. #dns_domain_ESSID="some.domain"
  172. #dns_search_domains_ESSID="search.this.domain search.that.domain"
  173. # Please check the man page for resolv.conf for more information
  174. # as domain and search (searchdomains) are mutually exclusive and
  175. # searchdomains takes precedence
  176.  
  177. # You can also set any of the /etc/conf.d/net variables per MAC address
  178. # incase you use Access Points with the same ESSID but need different
  179. # networking configs. Below is an example - of course you use the same
  180. # method with other variables
  181. #mac_config_001122334455=( "dhcp" )
  182. #mac_dhcpcd_001122334455="-t 10"
  183. #mac_dns_servers_001122334455=( "192.168.0.1" "192.168.0.2" )
  184.  
  185. # Map a MAC address to an ESSID
  186. # This is used when the Access Point is not broadcasting it's ESSID
  187. # WARNING: This will override the ESSID being broadcast due to some
  188. # Access Points sending an ESSID even when they have been configured
  189. # not to!
  190. # Change 001122334455 to the MAC address and ESSID to the ESSID
  191. # it should map to
  192. #mac_essid_001122334455="ESSID"
  193.  
  194. # This lists the preferred ESSIDs to connect to in order
  195. # ESSID's can contain any characters here as they must match the broadcast
  196. # ESSID exactly.
  197. # Surround each ESSID with the " character and seperate them with a space
  198. # If the first ESSID isn't found then it moves onto the next
  199. # If this isn't defined then it connects to the first one found
  200. #preferred_aps=( "ESSID 1" "ESSID 2" )
  201.  
  202. # You can also define a preferred_aps list per interface
  203. #preferred_aps_eth0=( "ESSID 3" "ESSID 4" )
  204.  
  205. # You can also say whether we only connect to preferred APs or not
  206. # Values are "any", "preferredonly", "forcepreferred", "forcepreferredonly" and "forceany"
  207. # "any" means it will connect to visible APs in the preferred list and then any
  208. # other available AP
  209. # "preferredonly" means it will only connect to visible APs in the preferred list
  210. # "forcepreferred" means it will forceably connect to APs in order if it does not find
  211. # them in a scan
  212. # "forcepreferredonly" means it forceably connects to the APs in order and does not bother
  213. # to scan
  214. # "forceany" does the same as forcepreferred + connects to any other available AP
  215. # Default is "any"
  216. #associate_order="any"
  217. #associate_order_eth0="any"
  218.  
  219. # You can define blacklisted Access Points in the same way
  220. #blacklist_aps=( "ESSID 1" "ESSID 2" )
  221. #blacklist_aps_eth0=( "ESSID 3" ESSID 4" )
  222.  
  223. # If you have more than one wireless card, you can say if you want
  224. # to allow each card to associate with the same Access Point or not
  225. # Values are "yes" and "no"
  226. # Default is "yes"
  227. #unique_ap="yes"
  228. #unique_ap_eth0="yes"
  229.  
  230. # IMPORTANT: preferred_only, blacklisted_aps and unique_ap only work when
  231. # essid_eth0 is not set and your card is capable of scanning
  232.  
  233. # NOTE: preferred_aps  list ignores blacklisted_aps - so if you have
  234. # the same ESSID in both, well, you're a bit silly :p
  235.  
  236.  
  237. ##############################################################################
  238. # ADVANCED CONFIGURATION
  239. # 
  240. # Two functions can be defined which will be called surrounding the
  241. # associate function.  The functions are called with the interface
  242. # name first so that one function can control multiple adapters.
  243. #
  244. # The return values for the preassociate function should be 0
  245. # (success) to indicate that configuration or deconfiguration of the
  246. # interface can continue.  If preassociate returns a non-zero value, then
  247. # interface configuration will be aborted.
  248. #
  249. # The return value for the postassociate function is ignored
  250. # since there's nothing to do if it indicates failure.
  251.  
  252. #preassociate() {
  253. #    # The below adds two configuration variables leap_user_ESSID
  254. #    # and leap_pass_ESSID. When they are both confiugred for the ESSID
  255. #    # being connected to then we run the CISCO LEAP script
  256. #
  257. #    local user pass
  258. #    eval user=\"\$\{leap_user_${ESSIDVAR}\}\"
  259. #    eval pass=\"\$\{leap_pass_${ESSIDVAR}\}\"
  260. #
  261. #    if [[ -n ${user} && -n ${pass} ]]; then
  262. #        if [[ ! -x /opt/cisco/bin/leapscript ]]; then
  263. #            eend "For LEAP support, please emerge net-misc/cisco-aironet-client-utils"
  264. #            return 1
  265. #        fi
  266. #        einfo "Waiting for LEAP Authentication on \"${ESSID//\\\\//}\""
  267. #        if /opt/cisco/bin/leapscript ${user} ${pass} | grep -q 'Login incorrect'; then
  268. #            ewarn "Login Failed for ${user}"
  269. #            return 1
  270. #        fi
  271. #    fi
  272. #
  273. #    return 0
  274. #}
  275.  
  276. #postassociate() {
  277. #    # This function is mostly here for completeness... I haven't
  278. #    # thought of anything nifty to do with it yet ;-)
  279. #    # Return 0 always
  280. #    return 0
  281. #}
  282.